home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 August / Macworld (1997-08).dmg / Shareware World / Info / For Developers / InstallerMaker™ 4.0 Installer / Customizing InstallerMaker / Editing IM Resources / Customizing Progress Bars next >
Text File  |  1997-05-10  |  4KB  |  86 lines
  1. Customizing the Progress Dialog in InstallerMaker 4.0:
  2. ==================================================================
  3.  
  4. A technical memorandum.  
  5.  
  6. Copyright © 1990-97, Aladdin Systems, Inc., All Rights Reserved.
  7.  
  8. ==================================================================
  9.  
  10. This memo describes the procedure for modifying the installation progress
  11. dialogs that appear when an InstallerMaker product installer runs.  We will
  12. readily admit that the procedure isn't simple: we will probably come out with
  13. an integrated editor for this dialog in the near future.  But until then, we 
  14. release these notes for developers who want to change the appearance of this 
  15. dialog.
  16.  
  17. Why Not a DITL?
  18. ---------------
  19. Because we can't.  The Dialog Manager does not allow developers to control the
  20. order in which items redraw.  For a movable modal progress dialog, this means
  21. that we could not guarantee that the dialog would correctly redraw if a portion
  22. of the dialog was erased by another window.  By "rolling" our own window, we
  23. can get the control we needed, and that the Dialog Manager would deny us.  By
  24. using these resources instead of DITLs for our custom routines, we make our
  25. installers smaller, and help you get your software on less disks.
  26.  
  27. How to Modify the Progress Dialog
  28. ---------------------------------
  29. Until we produce an editor to modify our custom resources, you will need to
  30. modify these resources yourself to change the size of the progress dialog and
  31. the position of its items.  The dialog contains a few elements, all of which you
  32. can modify:
  33.  
  34. 1) A set of PICTs that act as a "backdrop";
  35. 2) A set of resources that position two text elements within the backdrop;
  36. 3) A resource that determines the position of the progress bar itself;
  37. 3) A set of resources that determine the font and font size for the text items;
  38. 4) A resource that sets the RGB color of the "fluid" that fills our progress
  39. bar "thermometor".
  40.  
  41. You'll need to modify these resources in Resorceror or ResEdit; we've supplied
  42. some templates to help you with this.
  43.  
  44. Progress screen (the "backdrop"):
  45. ---------------------------------
  46.  
  47. PICT 127 and 129  are pictures to display in progress window.  Window will be same size as
  48. this PICT and drawn in upper third of screen.
  49.  
  50. B&W is PICT 127
  51. Color is PICT 129.
  52.  
  53. (PICT 128 was the ID of the B&W PICT through IM 2.0.  It is no longer used 
  54. in IM as of version 2.0.1. )
  55.  
  56. Both PICTs need their progress bars to be in exactly the same place.
  57.  
  58. Note that a black and white PICT needs to be an old style, one bit deep
  59. picture.  Grey scale is *not* equivalent, and in fact, may crash older
  60. Macintoshes.  We recommend that you check your black and white pictures on a
  61. non-Color Quickdraw capable Macintosh, such as a Mac Plus running System
  62. Software 6.0.5 or earlier.
  63.  
  64.  
  65. Other Resources
  66. ---------------
  67. The following resources are used to nail various features down in the progress 
  68. dialog:
  69.  
  70.  
  71. Font 128: if one byte in length is a one byte absolute font number.
  72.         (this s/b used only with number 0 for system font, 1 for appl. font.)
  73.         Otherwise is a pascal string of the name of the font to use
  74.         ("Helvetica", "New York").
  75.         
  76. Font 129 is an unsigned byte with the point size to use.  (should have descenders <= 4)
  77.  
  78. Prog 1 is an 8 byte rectangle showing where the progress bar should be.
  79.  
  80. Rect 0 contains the rectangle where the current file being installed info
  81. should be shown.  The text will be drawn at coordinates left, bottom-4.
  82.  
  83. Rect 1 is the same for the count (x of y Items)
  84.  
  85. Colr 128 is a 3 word RGB color selector for the color of the progress bar.
  86.